Versi 1

Field	Isi
Dokumen ID	VBS-MST-007
Deskripsi	Master supplier: mendaftarkan pemasok baru atau dari buku kontak, lengkap dengan tempo pembayaran, PIC, informasi kontak, dan akun hutang, serta memantau saldo titipan (uang muka) per supplier
Nomor Revisi	1
Tanggal	2026-10-04
Keterangan	Dokumentasi baseline dari dokumentasi fitur demo dan kode FE

1. Ringkasan

a. In scope

• User dapat melihat daftar supplier dengan nama, kode supplier, tempo pembayaran, dan saldo titipan
• User dapat mencari supplier berdasarkan nama
• User dapat menambah supplier baru (nama depan, nama belakang) atau mengambil kontak yang sudah ada di buku kontak
• User dapat mengisi tempo pembayaran, PIC kontak supplier, email, telepon, provinsi, kota, dan alamat (termasuk alamat lain)
• User dapat memilih akun hutang supplier serta akun hutang gaji dan THR, hutang komisi, dan biaya gaji
• User dapat melihat detail dan mengubah supplier, termasuk menambah / menghapus PIC
• User dapat menghapus supplier dan memulihkan supplier dari arsip

b. Catatan

c. Kesimpulan

• [FE] -
• [BE] -

2. Functional Requirement

Kode	Deskripsi
FR-01	Sistem menampilkan daftar supplier aktif dengan kolom nama supplier, kode supplier, tempo pembayaran, dan saldo titipan
FR-02	Sistem menghitung saldo titipan dari sisa uang muka (DP) tercetak per lawan transaksi
FR-03	User dapat mencari supplier berdasarkan nama
FR-04	User dapat menambah supplier baru langsung atau dari buku kontak
FR-05	User dapat menambahkan satu atau lebih PIC kontak supplier
FR-06	User dapat memilih akun hutang, akun hutang gaji dan THR, akun hutang komisi, dan akun biaya gaji
FR-07	Jika supplier diambil dari buku kontak dan informasi kontaknya diubah, alamat lama kontak diganti dengan alamat baru
FR-08	User dapat melihat detail supplier
FR-09	User dapat mengubah data supplier, tempo, PIC, dan akun
FR-10	User dapat menghapus supplier dan memulihkannya dari arsip secara massal

3. Use Case List

Kode	Deskripsi
UC-01	Melihat dan mencari daftar supplier beserta saldo titipan
UC-02	Menambah supplier baru
UC-03	Menambah supplier dari buku kontak
UC-04	Melihat detail supplier
UC-05	Mengubah supplier, PIC, dan akun
UC-06	Menghapus supplier
UC-07	Memulihkan supplier dari arsip

4. Use Case Scenario

UC-01 : Melihat dan mencari daftar supplier beserta saldo titipan

Aktor	User brand dengan hak #supplier
Deskripsi	User melihat daftar supplier dan saldo titipannya
Prekondisi	User sudah login
Alur utama	1. User membuka menu Master, Kontak, Supplier (atau tab Supplier di Buku Kontak). 2. Sistem menampilkan nama, kode, tempo pembayaran supplier. 3. Sistem menghitung dan menampilkan saldo titipan per supplier. 4. User mengetik nama untuk mencari.
Alur negatif	- Jika gagal memuat, daftar kosong. - Jika saldo titipan gagal dimuat, kolom saldo tetap kosong.
Bisnis rule	- Saldo titipan = jumlah sisa DP yang sudah tercetak dan masih di atas 0 per supplier.
Postkondisi	Daftar supplier tampil
Trigger	User membuka menu Supplier
Kode FR	FR-01 FR-02 FR-03

UC-02 : Menambah supplier baru

Aktor	User brand dengan hak basic
Deskripsi	User mendaftarkan supplier yang belum ada di buku kontak
Prekondisi	User sudah login
Alur utama	1. User klik Tambah. 2. User mengisi nama depan, nama belakang, tempo pembayaran, PIC kontak supplier. 3. User mengisi email, nomor telepon, provinsi, kota, alamat, dan alamat lain bila ada. 4. User memilih akun-akun supplier. 5. User klik Simpan. 6. Sistem menampilkan "Berhasil buat Supplier".
Alur negatif	- Jika form tidak valid, muncul "Silahkan cek kembali form isian!". - Jika simpan gagal, muncul pesan error dari server.
Bisnis rule	- Relasi kontak otomatis diset sebagai supplier. - Tempo pembayaran kosong disimpan 0. - Pilihan akun pada form tambah diambil dari akun berawalan 1204 dengan label "akun piutang", sedangkan yang dikirim sebagai akun hutang adalah field lain sehingga akun ini tidak ikut tersimpan. - Akun hutang gaji dari akun 2206, hutang komisi dari 2207, biaya gaji dari akun berawalan 5 dan 6.
Postkondisi	Kontak dan supplier baru tersimpan
Trigger	User klik Simpan
Kode FR	FR-04 FR-05 FR-06

UC-03 : Menambah supplier dari buku kontak

Aktor	User brand dengan hak basic
Deskripsi	User menjadikan kontak yang sudah ada sebagai supplier
Prekondisi	Kontak sudah ada di buku kontak
Alur utama	1. User klik Tambah lalu centang tambah dari buku kontak. 2. User memilih kontak. 3. Sistem mengisi informasi kontak dari kontak terpilih. 4. User melengkapi tempo pembayaran, PIC, dan akun. 5. User klik Simpan.
Alur negatif	- Jika form tidak valid, muncul "Silahkan cek kembali form isian!". - Jika simpan gagal, muncul pesan error dari server.
Bisnis rule	- Pilihan kontak tidak memuat kontak gudang. - Jika alamat, telepon, atau email diubah dari data kontak, alamat lama ditandai dihapus dan alamat baru disimpan. - PIC dikirim dengan penanda bahwa supplier berasal dari buku kontak.
Postkondisi	Kontak memiliki relasi supplier
Trigger	User klik Simpan
Kode FR	FR-04 FR-05 FR-07

UC-04 : Melihat detail supplier

Aktor	User brand dengan hak view
Deskripsi	User melihat informasi supplier, kontak, PIC, dan akun
Prekondisi	Supplier sudah ada
Alur utama	1. User klik baris supplier. 2. Sistem memuat data kontak dan supplier. 3. Sistem menampilkan detail termasuk akun hutang.
Alur negatif	- Jika gagal memuat, detail tampil kosong.
Bisnis rule	-
Postkondisi	Detail supplier tampil
Trigger	User klik baris
Kode FR	FR-08

UC-05 : Mengubah supplier, PIC, dan akun

Aktor	User brand dengan hak basic
Deskripsi	User memperbarui data supplier
Prekondisi	Supplier sudah ada
Alur utama	1. User membuka halaman ubah supplier. 2. Sistem memuat kontak, provinsi, supplier, dan daftar akun. 3. User mengubah nama, informasi kontak, tempo, PIC, dan akun. 4. User klik Simpan. 5. Sistem menampilkan "Berhasil diupdate".
Alur negatif	- Jika simpan gagal, muncul pesan error dari server.
Bisnis rule	- PIC yang dihapus dikirim dengan tanda deleted: true. - Tempo pembayaran hanya dikirim jika bernilai 0 atau lebih. - Field berlabel akun hutang dikirim ke server dengan kunci piutang.
Postkondisi	Data supplier terbarui
Trigger	User klik Simpan
Kode FR	FR-05 FR-06 FR-09

UC-06 : Menghapus supplier

Aktor	User brand dengan hak basic
Deskripsi	User menghapus supplier dari daftar aktif
Prekondisi	Supplier ada di daftar
Alur utama	1. User klik hapus pada baris. 2. Sistem meminta konfirmasi "Anda yakin ingin menghapus supplier (nama)?". 3. User konfirmasi. 4. Sistem menampilkan "Berhasil hapus supplier".
Alur negatif	- Jika server menolak (mis. masih punya transaksi), muncul pesan error dari server.
Bisnis rule	- Supplier yang dihapus dapat dipulihkan dari arsip.
Postkondisi	Supplier tidak tampil di daftar aktif
Trigger	User klik hapus
Kode FR	FR-10

UC-07 : Memulihkan supplier dari arsip

Aktor	User brand dengan hak archive
Deskripsi	User mengaktifkan kembali supplier
Prekondisi	Ada supplier tidak aktif
Alur utama	1. User membuka Arsip supplier. 2. User mencentang supplier, klik pulihkan, dan konfirmasi. 3. Sistem menampilkan "Berhasil memulihkan Supplier terpilih".
Alur negatif	- Jika gagal, muncul pesan error dari server.
Bisnis rule	- Pemulihan dilakukan massal.
Postkondisi	Supplier kembali aktif
Trigger	User klik pulihkan
Kode FR	FR-10

5. Data Flow Diagram

DFD-01

6. Sequence Diagram

SD-01 — UC-01 : Melihat dan mencari daftar supplier beserta saldo titipan

SD-02 — UC-02 : Menambah supplier baru

SD-03 — UC-03 : Menambah supplier dari buku kontak

SD-04 — UC-04 : Melihat detail supplier

SD-05 — UC-05 : Mengubah supplier, PIC, dan akun

SD-06 — UC-06 : Menghapus supplier

SD-07 — UC-07 : Memulihkan supplier dari arsip

7. Table Schema

8. API Schema

Endpoint	Status	Perubahan
POST /supplier/get-supplier	existing	-
GET /supplier/:id	existing	-
POST /supplier	existing	-
POST /supplier/existing	existing	-
POST /supplier/update-enchanced/	existing	-
DELETE /supplier/:id	existing	-
POST /supplier/bulk-update	existing	-
POST /financial-report/invoice-dp-report	existing	-
GET /person	existing	-
GET /person/:id	existing	-
GET /province	existing	-
GET /rekening	existing	-